home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Dr. Windows 3
/
dr win3.zip
/
dr win3
/
PROGRAMR
/
CLIKBR15.ZIP
/
CLICKBAR.DOC
< prev
next >
Wrap
Text File
|
1993-01-19
|
44KB
|
1,050 lines
Credits
──────────────────────────────────────────────────────────────────────
ClickBar, ClickDlg, and WynBtn were written by Dave Campbell.
The ClickBar toolkit was developed using the Borland C++ 3.0 Windows
Development package.
Copyright Notice
──────────────────────────────────────────────────────────────────────
Clickbar, ClickDlg, and WynBtn are Copyright 1992 by WynApse Software.
All rights are reserved.
This document is Copyright 1992 by WynApse Software.
All rights are reserved.
Trademarks
──────────────────────────────────────────────────────────────────────
Clickbar, ClickDlg, and WynBtn are trademarks of WynApse Software.
All trademarks and registered trademarks referenced within this
document are the property of their respective holders.
Warranty Disclaimer
──────────────────────────────────────────────────────────────────────
WYNAPSE SOFTWARE MAKES NO WARRANTY OF ANY KIND, EXPRESSED OR IMPLIED,
INCLUDING WITHOUT LIMITATION ANY WARRANTIES OF MERCHANTABILITY AND/OR
FITNESS FOR A PARTICULAR PURPOSE.
WYNAPSE SOFTWARE DOES NOT ASSUME ANY LIABILITY FOR THE USE OF THIS
SOFTWARE BEYOND THE ORIGINAL PURCHASE PRICE OF THIS SOFTWARE.
IN NO EVENT WILL WYNAPSE SOFTWARE BE LIABLE TO YOU FOR ANY ADDITIONAL
DAMAGES, INCLUDING ANY LOST PROFITS, LOST SAVINGS, OR OTHER INCIDENTAL
OR CONSEQUENTIAL DAMAGES ARISING FROM THE USE OF, OR INABILITY TO USE,
THIS SOFTWARE AND ITS ACCOMPANYING DOCUMENTATION, EVEN IF WYNAPSE
SOFTWARE, OR ANY AGENT OF WYNAPSE SOFTWARE HAS BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES.
Table of Contents
──────────────────────────────────────────────────────────────────────
Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Extracting Files. . . . . . . . . . . . . . . . . . . . . . . . 1
Installing Files into Windows . . . . . . . . . . . . . . . . . 1
Version 1.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 2
ClickBar.DLL . . . . . . . . . . . . . . . . . . . . . . . . . 2
ClickDlg.DLL . . . . . . . . . . . . . . . . . . . . . . . . . 2
TestClik.EXE . . . . . . . . . . . . . . . . . . . . . . . . . 2
ClikTest.EXE . . . . . . . . . . . . . . . . . . . . . . . . . 2
Included Files . . . . . . . . . . . . . . . . . . . . . . . . 3
Accessing ClickDlg. . . . . . . . . . . . . . . . . . . . . . . . 4
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 4
.C Program Header. . . . . . . . . . . . . . . . . . . . . . . 4
.C Program WinMain . . . . . . . . . . . . . . . . . . . . . . 5
Loading DLLs. . . . . . . . . . . . . . . . . . . . . . . . 5
Far Procedure Address Assignment. . . . . . . . . . . . . . 6
DLL End User Registration . . . . . . . . . . . . . . . . . 7
ClickDlg Setup call . . . . . . . . . . . . . . . . . . . . 8
ClickDlg Execution. . . . . . . . . . . . . . . . . . . . . 8
Freeing DLLs. . . . . . . . . . . . . . . . . . . . . . . . 8
.C Program WndProc . . . . . . . . . . . . . . . . . . . . . . 8
WM_SIZE and WM_MOVE . . . . . . . . . . . . . . . . . . . . 8
WM_COMMAND. . . . . . . . . . . . . . . . . . . . . . . . . 9
.RC File . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
.DLG File. . . . . . . . . . . . . . . . . . . . . . . . . . . 10
DLL bitmaps vs. binding bitmaps . . . . . . . . . . . . . . . . . 11
Button Profiles. . . . . . . . . . . . . . . . . . . . . . . . 11
ClickBar and the Resource Workshop. . . . . . . . . . . . . . . . 12
Installing ClickBar.DLL. . . . . . . . . . . . . . . . . . . . 12
Using the custom controls. . . . . . . . . . . . . . . . . . . 12
Button Types . . . . . . . . . . . . . . . . . . . . . . . . . 13
Button ID. . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Background Color . . . . . . . . . . . . . . . . . . . . . . . 13
User Registration . . . . . . . . . . . . . . . . . . . . . . . . 14
WYNAPSE.INI. . . . . . . . . . . . . . . . . . . . . . . . . . 15
End User Use . . . . . . . . . . . . . . . . . . . . . . . . . 16
Windows 3.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Borland C++ . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Registration. . . . . . . . . . . . . . . . . . . . . . . . . . . 17
ClickBar 1.0 ORDER FORM . . . . . . . . . . . . . . . . . . . . . 18
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Installation
──────────────────────────────────────────────────────────────────────
Extracting Files
────────────────
Build a "scratch" directory, preferably on a large RAM disk, that will
be used to temporarily extract the delivered ClickBar files. For
example,
C> cd \ <return>
C> md scratch <return>
C> cd scratch <return>
Copy the ClikBar1.ZIP file from the source diskette to the scratch
directory:
C> copy <diskette name>:\clikbar1.ZIP <return>
Execute Pkunzip to extract the two main files:
C> PKUNZIP CLIKBAR1 <return>
Read the Read.Me file for any last-minute additions:
C> type read.me|more <return>
Installing Files into Windows
─────────────────────────────
Start Windows, and from the Program Manager screen, execute
"File" "Run" C:\SCRATCH\SETUP.
Setup will propose a directory in which to install Clickbar. If the
proposed directory is unacceptable, change it as necessary, and press
OK. Setup will install ClickBar, and build a screen group named
WynApse for the TestClik and ClikTest programs. This will also provide
a convenient group for any test programs constructed using the
toolbar.
When SETUP is finished, and you next return to DOS, remove all the files
from the scratch directory, and delete the directory:
C> cd \scratch <return>
C> del *.* <return>
answer "Y" to the question about deleting all the files, then:
C> cd \ <return>
C> rd scratch <return>
Version 1.0
──────────────────────────────────────────────────────────────────────
Introduction
────────────
This document is the manual for ClickBar and ClickDlg. These two tools
are built for Microsoft Windows developers to use in producing
Windows applications with full-featured tool bars.
ClickBar.DLL
────────────
ClickBar v1.0 is delivered with 144 3-dimensional bitmapped buttons to
be used in any combination to provide users an exciting toolbar concept
instead of the standard pull-down menus. 75 of the buttons are "bound
into" the dynamic link library CLICKBAR.DLL, and the remainder are
provided as bitmaps for the developer to bind into the application, if
desired.
See the section entitled "DLL bitmaps vs. binding bitmaps" for
information and instructions on the available options.
ClickDlg.DLL
────────────
ClickDlg is the dynamic link library that provides the toolbar
interface itself to the user's application. A straight-forward,
40-line addition to an existing application will provide the user
with a toolbar interface.
TestClik.EXE
────────────
ClickBar is delivered with a demonstration, "TestClik.EXE". The
source code is included for TESTCLIK, and the section entitled
"Accessing Cl